home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 4 / Amiga Tools 4.iso / tools / packer / unzip512x / readme.ami < prev    next >
Encoding:
Text File  |  1996-02-26  |  6.2 KB  |  159 lines
  1.  
  2. Info-ZIP UnZip 5.12 README.AMI file, September 5, 1994
  3. Amiga specific notes for UnZip 5.12, release of August 28, 1994
  4. ==============================================================================
  5.  
  6.  
  7. GENERAL DESCRIPTION
  8. -------------------
  9.  
  10. The Info-ZIP UnZip 5.12 package consists of C source code that compiles
  11. on many platforms.  Some systems, such as Amiga, lack a bundled C language 
  12. compiler, so we package and distribute supported executables for those.
  13. This enables users who don't own compilers to utilize Info-ZIP programs.
  14.  
  15. For more information about Info-ZIP, and the enclosed utilities, please 
  16. consult the README and doc files included in this archive. The file "Where" 
  17. contians information and policies regarding availability of source and main
  18. archive locations.
  19.  
  20. Consult the file, "COPYING", for the policy regarding redistribution.
  21.  
  22. These programs run only as CLI commands, but are compatible with 
  23. Directory OPUS, SID, and IconX methods of execution.
  24.  
  25.  
  26. VERIFICATION OF VERSION
  27. -----------------------
  28.  
  29. The following output will display if you enter the command, "UnZip -v".
  30. If the dates and versions don't match, then this archive may have been
  31. tampered with.  Please provide the following information whenever you
  32. contact Info-ZIP regarding problems, comments, or questions (at least,
  33. the 3 lines flagged with "*" below).
  34.  
  35.  
  36. * UnZip 5.12 of 28 August 1994, by Info-ZIP.  Portions (c) 1989 by S. H. Smith.
  37. | Send bug reports to authors at zip-bugs@wkuvx1.wku.edu; see README for details.
  38. |
  39. | Latest sources and executables are always in ftp.uu.net:/pub/archiving/zip, at
  40. | least as of date of this release; see "Where" for other ftp and non-ftp sites.
  41. |
  42. * Compiled with SAS/C version 6.51 for AmigaDOS v38 on Sep  5 1994.
  43. |
  44. | UnZip special compilation options:
  45. *         [decryption]
  46. |
  47. | UnZip and ZipInfo environment options:
  48. |           UNZIP:  [none]
  49. |        UNZIPOPT:  [none]
  50. |         ZIPINFO:  [none]
  51. |      ZIPINFOOPT:  [none]
  52.  
  53. Note the bug reporting address documented in the above message.
  54.  
  55. Following is a directory listing showing file sizes and dates, 
  56. after restoring the archive:  
  57.  
  58.   README.AMI   (this file)    6338 ----rw-d 05-Sep-94 00:05:12
  59.   zipinfo.doc                21079 ----rw-d 25-Aug-94 13:18:56
  60.   Where                       9733 ----rw-d 25-Aug-94 11:17:52
  61.   COPYING                     8192 ----rw-d 10-Aug-94 21:47:08
  62.   CONTRIBS                    8435 ----rw-d 25-Aug-94 11:35:44
  63.   README                      9076 ----rw-d 28-Aug-94 21:24:04
  64.   unzip.doc                  33336 ----rw-d 25-Aug-94 13:18:54
  65.   UnZip                      85476 ----rwed 05-Sep-94 00:05:12
  66.   funzip.doc                  3592 ----rw-d 25-Aug-94 13:18:58
  67.   fUnZip                     26732 ----rwed 05-Sep-94 00:05:12
  68.  
  69.  
  70. INSTALLATION
  71. ------------
  72.  
  73. Installation should be performed manually.  Since the use of these utilities
  74. requires knowledge of file management and the AmigaDOS CLI, we do not expect
  75. this to hinder installation and usage.   Maybe we'll release a CLI script
  76. to do this in the future, but we have no plans to utilize the "installer"
  77. program, because it is too large to co-distribute and not guaranteed to exist.
  78.  
  79.  1.  Determine if programs are already installed.  Open an AmigaDOS shell
  80.      window, and type the following AmigaDOS commands to locate current
  81.      versions.  
  82.  
  83.          which UnZip
  84.          which fUnZip
  85.          which zipinfo
  86.  
  87.  2.  If zipinfo exists, delete it.  Zipinfo is now accessible via the
  88.      command, "UnZip -Z".  See step 4 below for zipinfo reinstallation.
  89.  
  90.  3.  a. If these files do NOT exist, then these utilities are not currently 
  91.         installed.  You must choose a location for them.  Enter the command,
  92.      
  93.            path
  94.  
  95.         Then choose a directory from the displayed list (called <dest> below).
  96.       
  97.      b. If the executable files DO exist, then substitute their locations
  98.         below, in place of "<dest>".
  99.  
  100.      c. Copy executables as follows, substituting for <unz512x> and <dest>:
  101.  
  102.            cd <unz512x>       ; <unz512x> contains the distribution archive.
  103.            copy UnZip  <dest>
  104.            copy fUnZip <dest>
  105.  
  106.  4.  If you want a "zipinfo" command, then you have 3 choices.
  107.  
  108.      a. Issue the command, "makelink from <dest>/zipinfo to <dest>/UnZip"
  109.  
  110.      b. Add, "alias zipinfo UnZip -Z" to the file, S:Shell-startup
  111.  
  112.      c. Just use "UnZip -Z" whenever you want Zipinfo.
  113.            
  114.  
  115. IMPLEMENTATION NOTES
  116. --------------------
  117.  
  118.  1.  It was discovered on release of UnZip 5.1 that the latest SAS compiler 
  119.      revision (6.50 or 6.51) changed the timezone handling.   The result is
  120.      that UnZip can extract files with the wrong times, usually off by an
  121.      offset of a few hours which is a function of the how the TZ environment
  122.      variable is set.  Now the TZ variable needs to be set according to the
  123.      timezone you are in, because the tzname() function operates correctly
  124.      now (it didn't used to).  If you do not set TZ to your current timezone,
  125.      files will be restored with times corrsponding to CST6, which is US/Central
  126.      time, the SAS/C default.  On the Amiga, the TZ variable cannot utilize
  127.      the daylight savings time extentions, so don't use them.  For example,
  128.      specify "EST5" instead of "EST5EDT".  The latter form will confuse the 
  129.      SAS/C libraries.  To set the TZ environment variable, place the following
  130.      line in your startup sequence (file S:startup-sequence):
  131.  
  132.           setenv TZ XXXN
  133.  
  134.              where XXX is the 3-character timezone notation
  135.                      N is the offset from Greenwich mean time
  136.  
  137.              examples:
  138.                  setenv TZ PST8  ; for California time
  139.                  setenv TZ EST5  ; for N'yuk N'yuk time
  140.  
  141.  2.  Wildcard support is limited to the most common types of usage. 
  142.      Estoteric pattern matching may not work.  For ease of use, the
  143.      Unix "*" character is equivalent to the Amiga "#?" pattern.
  144.  
  145. -------------------------------------------------------------------------
  146.  
  147. REPORT ALL BUGS AND COMMENTS TO INFO-ZIP:   <ZIP-Bugs@WKUVX1.WKU.EDU>
  148.  
  149. -------------------------------------------------------------------------
  150.  
  151. This Amiga port is brought to you by,
  152.  
  153.    John Bush    <John.Bush@East.Sun.COM>
  154.  
  155.    Paul Kienitz <Paul.Kienitz@shelter.sf.ca.us>
  156.  
  157. _________________________________________________________________________
  158.  
  159.